Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor qol tweaks #120

Closed
wants to merge 2 commits into from
Closed

Minor qol tweaks #120

wants to merge 2 commits into from

Conversation

kian99
Copy link
Contributor

@kian99 kian99 commented Dec 3, 2024

Description

This PR makes some minor QoL improvements:

  1. (First commit) Provide a flag to skip markdown escaping. The currently escaped character set doesn't seem to be an issue in all markdown readers. Additionally, I would like to convert my markdown to restructuredText and in that case the escaping is unneeded.
  2. (Second commit) Links to a different section of text in markdown should use - instead of _ for links with spaces. If a command has subcommands, the generated markdown would look like #command_subcommand and wouldn't properly navigate, instead #command-subcommand works.
  3. (Second commit) There is no line break between the end of the index file and the markdown separator ---- which causes issues when converting the markdown to other formats.

All tests still pass with these changes and I haven't opted to add new ones.

Links to a different section of text in markdown should use - instead of _ for links with spaces.
Also adds a newline before the line break marker in the index.
@kian99
Copy link
Contributor Author

kian99 commented Dec 4, 2024

Closing as this will need to change to land on top of #121

@kian99 kian99 closed this Dec 4, 2024
@kian99 kian99 mentioned this pull request Dec 4, 2024
jujubot added a commit that referenced this pull request Dec 4, 2024
#122

# Description

This PR recreates #120.

This PR makes some minor QoL improvements:
1. (First commit) Links to a different section of text in markdown should use - instead of _ for links with spaces. If a command has subcommands, the generated markdown currently resemble `#command_subcommand` and wouldn't properly navigate, instead `#command-subcommand` works.

2. (First commit) There is no line break between the end of the index file and the markdown separator `----` which causes issues when converting the markdown to other formats.

3. (Second commit) Always print command usage. The usage is only printed if a command has arguments, commonly empty for `list` style commands. But these commands should also have a usage section in the docs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant